home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / renegade / cdrm102.zip / CDRMAIL.DOC next >
Text File  |  1996-05-28  |  27KB  |  646 lines
  1.                            CDRMAIL version 1.02
  2.                                     by
  3.                             Charles D. Gaefke
  4.  
  5.  
  6.                                 Disclaimer
  7.                                 ----------
  8.  
  9. The author of CDRMAIL is not responsible for any damaged, corrupted, lost,
  10. or otherwise harmful occurrences which may occur from the use or inability
  11. to use this program.  This program has been tested and retested, and
  12. debugged, by myself and others.  To the best of my knowledge, CDRMAIL has
  13. no bugs, and will not cause any corrupted or lost data on a properly
  14. configured BBS.  To the best of my knowledge, it will not do anything more
  15. than what is documented herein.  However, I guarantee NOTHING, except that
  16. this program will take up hard drive space.
  17.  
  18.  
  19.                                  WARRANTY
  20.                                  --------
  21.  
  22. NO WARRANTY IS GIVEN, EITHER EXPRESSED OR IMPLIED, AS TO THE FUNCTIONALITY
  23. OF THIS SOFTWARE PROGRAM.  BY USING THIS SOFTWARE, YOU ARE AGREEING NOT TO
  24. HOLD THE AUTHOR, CHARLES D.  GAEFKE, RESPONSIBLE FOR ANY DAMAGES EITHER
  25. CONSEQUENTIAL OR INCIDENTAL, WHICH ARISE FROM YOUR ABILITY TO USE OR MISUSE
  26. THIS SOFTWARE PROGRAM.  YOU ARE FURTHER AGREEING, WITH YOUR USE OF THIS
  27. SOFTWARE PROGRAM, THAT YOU HAVE READ THIS ENTIRE DOCUMENT AND ARE FAMILIAR
  28. WITH ITS TERMS AND AGREE TO EXEMPT CHARLES D.  GAEFKE FROM ANY AND ALL
  29. RESPONSIBILITIES IN THE EVENT OF ANY DAMAGES TO YOUR SYSTEM WHICH ARE
  30. CAUSED EITHER THROUGH DIRECT OR INDIRECT USE OF THIS SOFTWARE PROGRAM.
  31.  
  32.  
  33.                        Shareware Concept/Grant of License
  34.                        ----------------------------------
  35.  
  36. CDRMAIL is a fully-functional (non-crippled) Shareware utility.  You are
  37. granted a license to use and CDRMAIL for as long as you wish.  If you use
  38. CDRMAIL as your echomail processor, I request that you register it.
  39. Registration is only $15.  Please see below for the registration form.  I
  40. do _NOT_ require registration.  If you do not want to register it, or you
  41. can not afford it, that is fine.  I also take trades (make an offer!) or
  42. just plain donations.
  43.  
  44.  
  45.                                Distribution
  46.                                ------------
  47.  
  48. Feel free to distribute CDRMAIL among your sysop friends.  However, I do
  49. ask that do so only in unmodified format, in the distribution CDRM102.ZIP
  50. archive, that contains the following files:
  51.  
  52. CDRMAIL.EXE
  53. CDRMAIL.DOC
  54. FILE_ID.DIZ
  55. WHATSNEW.TXT
  56.  
  57.  
  58.                                 Description
  59.                                 -----------
  60.  
  61. CDRMAIL is a Renegade echomail processor.  It converts .MSG files (created
  62. by your echomail tosser) to the Renegade message bases, and visa versa, in
  63. a very efficient manner, causing it to process mail EXTREMELY fast.
  64.  
  65.  
  66.                                  Features
  67.                                  --------
  68.  
  69. - Imports and optional purging of echomail in one pass.
  70. - Smart exporting of echomail.
  71. - Full netmail support.
  72. - Creates summary of echomail activity on each run.
  73. - Handles ANSI very well.
  74. - Optional logging of all activities to a log file of your specification.
  75. - Max size of 64,000 byte message size for importing/exporting.
  76. - Optional tossing of 1.MSG.
  77. - Optional absolute scan for exporting of echomail.
  78. - Supports multiple configurations via command line and optional
  79.   environmental variables.
  80.  
  81.  
  82.                                Requirements
  83.                                ------------
  84.  
  85. CDRMAIL requires Renegade version 10-05-94, 04-05-96 or 05-11-96 (see
  86. miscellaneous information).  Because CDRMAIL runs in conjunction with an
  87. echomail processor, such as GEcho, knowledge of configuring and running
  88. that echomail processor is also required.  And, since BBS's are run by
  89. batch files, batch file knowledge is required as well.
  90.  
  91. As for hardware requirements, CDRMAIL requires adequate hard drive space
  92. for the converted messages.  The volume of messages you process will
  93. determine how much hard drive space you need.  CDRMAIL requires a 80386
  94. processor, or better, to run.  Memory requirements are minimal (less than 
  95. 200k).  If you run it in the same sequence you run your echomail 
  96. tosser/scanner, CDRMAIL should have plenty of memory to work with.
  97.  
  98. CDRMAIL has been tested and it runs properly under DOS/DESQVIEW and OS/2
  99. Warp.  There may be problems under Windows 95.  I was unable to fully test
  100. it, so I can not guarantee it will work correctly.  If you do run Windows
  101. 95, and you do have problems, please let me know, and I will do my best
  102. to fix them ASAP.
  103.  
  104.  
  105.                                    Usage
  106.                                    -----
  107.  
  108. I think you will find CDRMAIL extremely easy to use.  I have provided below
  109. several examples of how to use CDRMAIL.  Note that my examples use GEcho for
  110. an echomail processor, and that I assume that you have installed GEcho in
  111. \GECHO and Renegade in \RENEGADE.  If using a different configuration of
  112. hard drive subdirectories and/or echomail processing software, please
  113. refer to the documentation that accompanied that echomail processor for
  114. information regarding its configuration and for tossing/scanning echomail.
  115.  
  116.  
  117. - For importing echomail:
  118.     CDRMAIL runs after you run your echomail processor.  This example will
  119. import all tossed messages, and purge them when done:
  120.  
  121. :mail_in
  122. rem Tossing messages with echomail processor.
  123. cd \gecho
  124. gecho toss
  125. rem Importing messages for Renegade.
  126. cd \renegade
  127. cdrmail -t -d
  128.  
  129.  
  130. - For exporting echomail:
  131.     CDRMAIL runs before you run your echomail processor.  Example:
  132.  
  133. :mail_out
  134. cd \renegade
  135. rem Exporting messages for processing by echomail processor.
  136. cdrmail -s
  137. rem Running echomail processor.
  138. cd \gecho
  139. gecho scan
  140. rem Deleting previously exported messages.
  141. cd \renegade
  142. cdrmail -d
  143.  
  144.  
  145.                                 Parameters
  146.                                 ----------
  147.  
  148. Commands:
  149.     -T  Toss inbound messages
  150.     -S  Scan outbound messages
  151. Options:
  152.         -D    Delete .MSG files
  153.         -N    No netmail
  154.         -O    Only netmail
  155.         -Pxxx Sets point threshold(def=256)
  156.         -1    Starts at 1.MSG
  157.         -A    Absolute scan
  158.         -B    Use BIOS output
  159.         -L    Logging enabled
  160.         -X    Xtended logging enabled
  161.         -V    Display version number
  162.  
  163.  
  164.                            Parameter Description
  165.                            ---------------------
  166.  
  167. -T (Toss Inbound Messages)
  168.     Imports any inbound messages, including any inbound netmail unless
  169. otherwise specified with "-N".
  170.  
  171. -S (Scan Outbound Messages)
  172.     Processes any outbound echomail messages, including netmail unless
  173. otherwise specified with "-N".
  174.  
  175. -D (Delete .MSG Files)
  176.     Causes CDRMAIL to purge all message files (*.MSG) found in your
  177. echomail paths.  If used with -T, CDRMAIL will purge them IMMEDIATELY
  178. after importing them.
  179.  
  180.     Please note that after exporting mail, with -S, and running your
  181. echomail processor, I recommend you running CDRMAIL -D to remove the
  182. exported messages.
  183.  
  184. -N (No Netmail)
  185.     Causes CDRMAIL -not- to process netmail when importing or exporting.
  186. Can not be used with "-O".
  187.  
  188. -O (Only Netmail)
  189.     Causes CDRMAIL to -only- process netmail when importing or exporting.
  190. Can not be used with "-N".
  191.  
  192. -Pxxx (Point Threshold)
  193.     According to certain standards (Fidonet), the point field of the
  194. address is not required to be specified when creating netmail.  Because
  195. of this, Netmail sometimes has a "garbage" point address on it.  CDRMAIl
  196. compensates for this by checking the point address.  If it is larger than
  197. 256, it assumes it is meaningless, and sets it to 0.  If, for whatever
  198. reason, you want to change the threshold (default is 256), that is what
  199. this parameter is for.  Most systems will not need this parameter.
  200.  
  201. -1 (Import 1.MSG)
  202.     When importing echomail, CDRMAIL will look for 1.MSG, and if found,
  203. will import it.  This is an option because 1.MSG is usually used for what
  204. is called a high message pointer for echomail tossers.  Use at your
  205. discretion.
  206.  
  207. -A (Absolute Scan)
  208.     By default, CDRMAIL does "smart" exporting.  That is, Renegade leaves a
  209. "trace" for echomail processors so they know which bases contain messages
  210. to be exported.  By default, CDRMAIL scans for this "trace" and processes
  211. an echomail base only if that "trace" is found.  With the "-A" parameter, the
  212. trace is not searched for; CDRMAIL will scan every message of every base
  213. looking for unsent messages.
  214.  
  215.     Note that if a message gets corrupted before exporting, the "trace" is
  216. usually not activated, and will not be exported.  Using absolute scan will
  217. create garbled messages (that your moderator will love, I am sure) if
  218. corrupted messages exist.  Use at your own discretion.
  219.  
  220. -B (BIOS Video Output)
  221.     By default, CDRMAIL performs direct screen writes.  Some operating
  222. systems/display cards prefer that programs use BIOS routines for screen
  223. writing so that they can control it more.  Use this option if you get screen
  224. "bleeding" from one window to another (such as in DESQview) or "snow" (on CGA
  225. graphics cards), or if your graphics card is not 100% IBM compatible and
  226. seems to be displaying CDRMAIL's reports incorrectly (garbled text, etc.).
  227.  
  228.     If you have a need for this parameter, you know why it is here already :)
  229. If you have never heard the term "BIOS Video Output" before, then do not
  230. worry about this parameter.  "-B" is for cosmetic function -only- and does
  231. not affect the processing of mail in any way.
  232.  
  233. -L (Logging Enabled)
  234.     By default, CDRMAIL does not do any logging functions.  If you want it
  235. to log, use the -L command.
  236.  
  237. -X (Xtended Logging)
  238.     By default, if logging is specified, CDRMAIL records only the time it
  239. was run, the parameters used, and summary of processing.  If detailed
  240. logging is specified, CDRMAIL records all default logging information plus
  241. activity/actions for each base.  For systems that handle a large amount of
  242. mail, this can take up a significant amount of hard drive space and slow
  243. system performance rather quickly, hence its optional status.  The
  244. parameter -L is not necessary if -X is used.
  245.  
  246.     You may wish to use -X during your initial tests of CDRMAIL from the
  247. command line to learn exactly what CDRMAIL is doing with your mail and to
  248. verify its correctness and efficiency.  Then please remove its use for
  249. day-to-day operation with your system to really see CDRMAIL in action!
  250.  
  251. -V (Display version)
  252.     I added this just so you know exactly what version of CDRMAIL you are
  253. using.  Generally, CDRMAIL has the same version as the most recent version
  254. of Renegade.  Unfortunately, though, there may be more than one version of
  255. CDRMAIL released for one version of Renegade (for example, version 1.01 and
  256. 1.02 are both for 05-11-96).  So, if you want to know what version of
  257. CDRMAIL you have, run CDRMAIL -V. :)
  258.  
  259.  
  260.                                   Logging
  261.                                   -------
  262.  
  263. By default (if logging is enabled), CDRMAIL writes to a log file called
  264. CDRMAIL.LOG in the LOGS path specified in your Renegade configuration.  You
  265. can override this default behavior by using the environment variable
  266. CDRMAIL.  To do this, use the DOS command SET, as follows:
  267.  
  268.       SET CDRMAIL=d:\path\filename.ext
  269.  
  270. where "d:" is the drive letter, "path" is the pathname, and "filename.ext" is
  271. the name of the file into which you want CDRMAIL to write its statements.
  272. For example, in your AUTOEXEC.BAT, put:
  273.  
  274.       SET CDRMAIL=c:\logs\cdrmail.log
  275.  
  276. Then, every time CDRMAIL is run, the file C:\LOGS\CDRMAIL.LOG will be
  277. appended with new log information.
  278.  
  279. Note that you can use any valid DOS path and filename you desire - but the
  280. path, if specified, MUST exist.  Otherwise CDRMAIL will exit with an error
  281. and -will not- process your mail!
  282.  
  283.  
  284.                                    Speed
  285.                                    -----
  286.  
  287. On my system, CDRMAIL _FLIES_.  With 2 nodes running in the background,
  288. plus whatever else I may be doing, I typically get 30+ messages tossed a
  289. SECOND.  My system is a Pentium 90 with 16 megs of RAM, and I run OS/2
  290. Warp.  If your messages/sec is much slower than mine, and you have a system
  291. comparable to mine, there may be an internal problem with CDRMAIL, or you
  292. could do some optimizing of your system.
  293.  
  294. All mail tossers, CDRMAIL included, LOVE a disk cache.  A disk
  295. cache helps IMMENSELY when tossing mail - especially a write-behind disk
  296. cache.  For DOS, Smartdrv (in your DOS directory) or HyperDisk (by
  297. HyperWare) are excellent disk caches.  For OS/2, mail tossing works best on
  298. a HPFS drive with a fairly large CACHE specified (I have a 2 meg cache).
  299. Please see your manuals for installation of this software.
  300.  
  301. BE FOREWARNED - A write behind (lazy-write) cache is not for everyone.
  302. There are hazards to a write behind cache.  They function by storing
  303. recently written data to memory, and it is eventually written to disk.
  304. If your system is unstable - or if you have frequent power outages
  305. (without a UPS), I do not recommend using a write-behind cache.
  306.  
  307.                   !!!USE THEM AT YOUR OWN RISK!!!
  308.  
  309. If you decide not to use a write-behind disk cache, a "normal" cache will
  310. help immensely as well.
  311.  
  312.  
  313.                               Time Estimation
  314.                               ---------------
  315.  
  316. CDRMAIL calculates the local time from the DOS environment variable TZ.
  317. Most BBS's should have this variable set already, since several popular
  318. programs make use of it.  If you do not currently use TZ, and are not located
  319. in the eastern time zone (see note #2), the TZ environment variable is not
  320. very difficult to add.
  321.  
  322. The TZ variable is in the following format:
  323.  
  324.       xxxNyyy
  325.  
  326. Where xxx is your time zone (ex: EST), N is the time zone difference between
  327. your zone and Greenwich, and yyy is the your time zone initials if/when you
  328. observe Daylight Savings time.  The yyy is not necessary - if it is omitted,
  329. it simply means you do not observe Daylight Savings time and the time
  330. will not be adjusted.
  331.  
  332. Set the variable in your AUTOEXEC.BAT, by adding:
  333.  
  334.       SET TZ=xxxNyyy
  335.  
  336. substituting xxxNyyy with your settings, of course.  For example, in my
  337. AUTOEXEC.BAT, I have:
  338.  
  339. SET TZ=EST5EDT
  340.  
  341.  
  342. Note 1: If you are unsure what amount of time zone difference there is
  343. between your location and Greenwich, consider that the setting for Eastern
  344. Standard Time is EST5EDT.  If you live in California, you are three hours
  345. behind EST, so you would use PST8PDT.
  346.  
  347. Note 2: If TZ is not present, CDRMAIL assumes TZ=EST5EDT.
  348.  
  349.  
  350.                                 Error levels
  351.                                 ------------
  352.  
  353. CDRMAIL does support DOS error levels.  They are listed in the following
  354. table:
  355.  
  356. ERROR LEVEL        Meaning
  357. =============================================================================
  358.    0           Normal Completion - No errors encountered.
  359.    3           Insufficient memory to process mail.  Mail was NOT processed.
  360.    5           File not found.  A file CDRMAIL was searching for could not
  361.                be found.  Some mail processing may have occurred before
  362.                this error.  This could be a user problem or an internal
  363.                problem with CDRMAIL.
  364.   10           User Break (Ctrl-Break).  The user has terminated CDRMAIL.
  365.                Some mail may have been processed before the user break.
  366.  
  367. Since every process in CDRMAIL is logged, if you check your log file you will
  368. see exactly what when wrong and when.  I implemented the error levels just for
  369. those who may want them/are able to handle them in BATCH files :)
  370.  
  371. Note that unlike Renemail, there is no error-level if CDRMAIL "chokes" on a
  372. message because CDRMAIL does not choke on messages.  Nor does CDRMAIL "hang"
  373. either.  (If it does either, there is an internal problem with CDRMAIL.)
  374. There is no easy for CDRMAIL to determine if a message is really garbled
  375. or not.  So any garbled messages will be imported, as they are.
  376.  
  377.  
  378.                                Registration
  379.                                ------------
  380.  
  381. CDRMAIL is Shareware.  Not the -normal- Shareware, because I do _NOT_
  382. require registration.  If you want to register CDRMAIL, I will be more than
  383. happy to accept it.
  384.  
  385. However, until CDRMAIL is registered, it will display "UNREGISTERED" in a
  386. couple of places, and a seven second delay will occur upon successful
  387. completion of CDRMAIL.
  388.  
  389. Registration of CDRMAIL costs only US$15.00.  Considering the amount of time
  390. I have put into CDRMAIL, and how useful and efficient it is, I consider this
  391. to be a small price to pay for the performance gained.  Upon registration:
  392.  
  393. 1) You will receive a registration key;
  394. 2) You will be supporting the shareware concept;
  395. 3) You will be encouraging me to write more utilities; and
  396. 4) All unregistered "features" will be removed.
  397.  
  398. To register, please print this form and mail it with your check or money
  399. order to:
  400.  
  401.             CHARLES D. GAEFKE
  402.             128 PLUM RUN ROAD
  403.             CANONSBURG, PA  15317
  404.  
  405. I will process your order for CDRMAIL upon receipt, and will deliver it
  406. immediately using the method you have specified.
  407.  
  408. International orders welcomed!  All personal checks, however, must be drawn
  409. in US funds on a US bank.  Canadian residents may obtain a money order in US
  410. funds at their local bank or post office.  Other countries please inquire at
  411. your local bank or postal office about an International Money Order (IMO).
  412.  
  413.                                 (cut here)
  414. ---------------------------------------------------------------------------
  415. Registration form for CDRMAIL version 1.02.
  416.  
  417.  
  418.   Your REAL name:
  419.  
  420.       Address #1:
  421.  
  422.       Address #2:
  423.  
  424. City, State, Zip:
  425.  
  426.          Country:
  427.  
  428.  
  429. I can send you your registration key two ways:
  430. 1) I can crash it to you via Netmail if you have an address that I have a
  431.    nodelist for.
  432. 2) I can call your BBS and upload it (leave data phone #).
  433.  
  434. Preference:
  435.  
  436.  
  437. These are not required, but I would appreciate you filling them out so I
  438. know exactly what types of systems CDRMAIL is running on.
  439.  
  440. Hardware
  441.              CPU:            RAM:
  442.  
  443.  
  444. Why are you registering CDRMAIL?
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Enclosed is $____.
  451.  
  452.    [ ] Check      [ ] Money Order   [ ] International Money Order (IMO)
  453.  
  454. By signing below, I agree that by registering this program, I am in no way
  455. purchasing and am in no way granted partial ownership or rights to CDRMAIL.
  456. I am paying for a non-transferable license to use CDRMAIL on my system
  457. indefinitely and to support the author and the shareware marketing concept.
  458. In return for my payment, however, I expect to receive a registration key
  459. which will disable any unregistered "features" of CDRMAIL.
  460.  
  461. Signature: ______________________________   Date:  __/__/__
  462.  
  463. Please make check or money order payable to Charles D. Gaefke.
  464.  
  465. ---------------------------------------------------------------------------
  466.  
  467.  
  468.                                 Bug Reports
  469.                                 -----------
  470.  
  471. At the present time, there are no known bugs with CDRMAIL.  Hopefully there
  472. will not be any more. :)
  473.  
  474. In the event that a bug is found, however, please let me know!  For me to
  475. fix it, I will require as much information as you can give me.  So, when
  476. contacting me about a bug, please include:
  477.  
  478. Your operating system and version;
  479. Version of Renegade you were using when the bug occurred;
  480. Command line parameters used when the bug occurred;
  481. Can you make CDRMAIL do this again?  If so, how?
  482. If at all possible, the message(s) that caused the problem would help
  483. IMMENSELY.
  484. Any other information/comments you think will be helpful to me.  Basically,
  485. give me a short text description of what happened.
  486.  
  487.  
  488.                                How It Works
  489.                                ------------
  490.  
  491. Special notes on how CDRMAIL functions, for those who may be curious, and
  492. are familiar with how Renegade works:
  493.  
  494.  
  495. Q. How does CDRMAIL distinguish what Netmail messages to import?
  496.  
  497. A: First it checks the origin address of the netmail message to see if it
  498. is from one of your AKA (specified in your Renegade setup).  If no match is
  499. found, it checks the destination address for a match against your AKA's.
  500. If one is found, CDRMAIL checks the destination name against your user
  501. database.  If a match is found, it is imported for that user.  If not, it
  502. is still imported, but for user #1.
  503.  
  504.  
  505. Q. What is the HI_WATER.MRK file in all of my echomail directories?
  506.  
  507. A. CDRMAIL uses the HI_WATER.MRK file to keep track of what messages have
  508. been imported (so that it does not import them again).  The HI_WATER.MRK
  509. file contains two things - the number of the last message imported, and the
  510. date/time stamp of that message.
  511.  
  512.  
  513. Q. How does CDRMAIL import messages?
  514.  
  515. A: First CDRMAIL checks for a match to the filespec (*.MSG) for the area.
  516. If a match is found, CDRMAIL checks the HI_WATER.MRK file (see above),
  517. reading the number of the last message imported, and the date/time stamp of
  518. it.  CDRMAIL then checks to see if that message exists and IF it has the
  519. same date/time stamp as the HI_WATER.MRK indicates.  If a match is made,
  520. CDRMAIL starts importing at the next message (if it exists).  If there is
  521. no match, CDRMAIL starts importing at 2.MSG (1.MSG if -1 is used; if -1 is
  522. used and 1.MSG is not found, it goes to 2.MSG).  *IF* 1.MSG or 2.MSG is not
  523. the first message, THERE WILL BE AN ERROR!  Mail tossers toss from 1.MSG or
  524. 2.MSG on - therefore if *.MSG is found, CDRMAIL assumes the first message
  525. is 2.MSG (or 1.MSG).  CDRMAIL keeps importing, as long as the next message
  526. exists.  That means if you 2.MSG, 3.MSG, and 5.MSG in your directory,
  527. CDRMAIL will import #2, #3, see that #4 does not exist, stop there.
  528.  
  529. The ONLY exception to this is when CDRMAIL processes Netmail.  When CDRMAIL
  530. processes Netmail, it reads the numbers of all the messages (since they can
  531. vary in number), and sorts them out.  CDRMAIL then processes them one at a
  532. time, in the order then exist.  Note that if, by chance, one of the netmail
  533. messages is deleted (such as on a multi-node system that just sent/received
  534. a mail call) before CDRMAIL processes it, and after CDRMAIL acknowledges it
  535. is there, CDRMAIL will give an error, and abort.  However next time CDRMAIL
  536. runs, things will proceed as normal with no data lost.
  537.  
  538.  
  539. Q. How does CDRMAIL purge messages?
  540.  
  541. A. If -D (purging) is used with -T, CDRMAIL purges *ONLY* if messages are
  542. imported.  If not, CDRMAIL does not check to see if there are messages to
  543. be purged.  If -D is used by itself, CDRMAIL deletes any match it finds to
  544. the *.MSG specification, one at a time (unfortunately I have found no way
  545. to purge them all at once, such as "DEL *.MSG"), as it finds them.
  546.  
  547.  
  548. Q. How does CDRMAIL export message?
  549.  
  550. A. This is relatively self-explanatory, but I have included it because I
  551. have the other 3 main functions in here. :)  Unless the -A is used, CDRMAIL
  552. checks each base for the "marker" indicating it has messages that are not
  553. sent.  When it finds one, it searches through all the messages until it
  554. finds one that is unsent (and validated), and exports it to the next .MSG
  555. number.  That is, if you have 2.MSG-100.MSG in your directory when CDRMAIL
  556. exports, CDRMAIL will start exporting as 101.MSG, then 102.MSG, etc.  If
  557. the -A parameter is used, CDRMAIL checks every base for any message that
  558. has not been sent (and is validated).
  559.  
  560.  
  561. Q. What is the CDRMAIL.DAT I have in my Renegade directory?
  562.  
  563. A. The CDRMAIL.DAT contains all the data CDRMAIL needs from your message
  564. base info (MBASES.DAT).  If you will compare the size of the two, you will
  565. see there isn't much from the MBASES.DAT that CDRMAIL needs.  With this in
  566. mind, CDRMAIL can run faster because it doesn't have access everything in
  567. the MBASES.DAT (whether it read the whole thing into memory or if it
  568. "jumps" through it finding what it needs).  In the CDRMAIL.DAT is a
  569. date/time stamp of the MBASES.DAT when CDRMAIL was last executed.  When
  570. CDRMAIL runs, it compares that date/time stamp to the one on the
  571. MBASES.DAT.  If it is different, CDRMAIL assumes the MBASES.DAT has been
  572. changed, and a new CDRMAIL.DAT is created with a new date/time stamp
  573. reflecting the new MBASES.DAT in it.
  574.  
  575.  
  576.                          Miscellaneous Information
  577.                          -------------------------
  578.  
  579. This is the third 'official' release of a program for me.  My first was
  580. GEMC, a program to keep a daily record of imported messages from GEcho.
  581. The second was RGNSHOW, a program to reflect the status of other nodes from
  582. the command line.  There are more programs in the making, and still more
  583. ideas I have not started yet.
  584.  
  585. In case anyone is wondering, CDRMAIL stands for CD's Renegade MAIL
  586. processor.
  587.  
  588. I am in no way affiliated with any group or company.  I author alone.
  589.  
  590. CDRMAIL was compiled with Borland C++ v 3.1 creating Intel 80386 code.  That
  591. is, CDRMAIL requires a 386 or better microprocessor to run.  I figure there
  592. should not be anyone using anything older than a 386 anymore.  If so, my
  593. apologies - please upgrade.
  594.  
  595. Source code (approx 1600 lines amounting to 39k) is NOT available for sale
  596. or study.
  597.  
  598. CDRMAIL is coded based on the Renegade 04-05-96 structures (100% compatible
  599. with 05-11-96).  However, because Cott surprised us all with a new version
  600. of Renegade shortly before version 1.00 of CDRMAIL was completed, this mail
  601. processor is backwards compatible with 10-05-94.
  602.  
  603. Future updates to CDRMAIL will, most likely, no longer support 10-05-94.
  604. Provided no major changes are made to the format of Renegade's structures,
  605. CDRMAIL should work for any version from 10-05-94 on.  I can not, however,
  606. guarantee anything that CDRMAIL will work on anything other than 10-05-94,
  607. 04-05-96, and 05-11-96.
  608.  
  609. If a release is made with modified structures, I will update CDRMAIL as soon
  610. as I get the structures for the upgraded Renegade.
  611.  
  612. The latest version of CDRMAIL can always be FREQed as 'CDRMAIL' from
  613. 50:530/1 or 1:129/230, my BBS, Cott Lang's BBS, and hopefully on
  614. ftp.cc.umanitoba.ca.  I plan on having a Web Page in the future that will
  615. have CDRMAIL on it.
  616.  
  617.  
  618.                                   Credits
  619.                                   -------
  620.  
  621. My thanks to Borland for their IDE interface.  Without it I would be lost.
  622. Many thanks to Cott Lang for Renegade - the best BBS around.
  623.  
  624. Merci beaucoup to my girlfriend Tasha for listening to all my gripes and
  625. complains when things did not go the way they should while programming.
  626.  
  627. Many thanks to my Beta testers, Robert Colbert (A.K.A. Linc) and Bill
  628. Thoma.  They found a lot of my bugs in the beta versions and offered advice
  629. that helped the creation of CDRMAIL.  Thanks guys!
  630.  
  631.  
  632.                   Suggestions, Questions, and/or Comments
  633.                   ---------------------------------------
  634.  
  635. Questions, technical support and comments about CDRMAIL, or any of my
  636. software, may be sent to me via netmail at 1:129/230@Fidonet.org or
  637. 50:530/1@RGSNet.  I am also reachable in all of the RGSNet
  638. echos. Or, if you prefer, you can snailmail me at
  639.  
  640. LOTL
  641. c/o Charles Gaefke
  642. 128 Run Road
  643. Canonsburg, PA  15317-9801.
  644.  
  645. -C. Gaefke
  646.